home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / ami-express / v-z / vty-ad12.lha / Documentation < prev    next >
Text File  |  1993-02-26  |  7KB  |  206 lines
  1.  
  2. Documentation For Mr. Sinister V1.25
  3. ------------------------------------
  4.  
  5. Disclaimer:
  6. -----------
  7.  
  8. I, the programmer of this program, can not be held responsible
  9. in any way, especially not economically, for any damage this
  10. program may cause to your data, your hardware, your finacial
  11. situation or your life.
  12.  
  13. Credits:
  14. --------
  15.  
  16. Wardancer from Vanity made Mr. Sinister including this
  17. documentation.
  18.  
  19. Also, some big thanks to the following dudes how betatested
  20. for me:     Zany at Susperia (+45 4343-4236)
  21.             Gilthanas at Warez Unlimited (+45 4494-6208)
  22.             Manace (who didnt test it at his board :( )
  23.  
  24. What is it:
  25. -----------
  26.  
  27. If you don't know what it is, then why did you download it ?
  28. Well, I admit it, the name is a bit cryptic, so let me
  29. explain what 'Mr. Sinister' is. 'Mr. Sinister' is a program
  30. that lets you add all kinds of ad's to .lha archives, when I
  31. say all kinds of ad's I mean ad's with random names and the
  32. likes.
  33.  
  34. How does it work:
  35. -----------------
  36.  
  37. Well, it is quite simple, the program will look for a icon
  38. containing some tooltypes, the icons name must be
  39. 'config.info', and must be placed in 'Doors:!!!War!!!/Adder',
  40. or in the same directory as the adder itself (progdir:).
  41.  
  42. The tooltypes is as follows:
  43.  
  44. FLAGS       Flags that can be set to make the adder do some
  45.             extra stuff.
  46.  
  47. TYPE.x      Indicates what type of ad you want. So far the
  48.             following types are supported:
  49.  
  50.             NORMAL          For normal ad's (nothing random).
  51.             LHANAME         For ad's using the archives name.
  52.             RNDCHARS        For ad's using random characters.
  53.             RNDINTS         For ad's using random integers.
  54.             RNDCHARS&INTS   For ad's using both random
  55.                             characters adn integers.
  56.             RNDAMOK         As above just with weird signs
  57.                             included.
  58.             TICTACTOE       For random words.
  59.             DECREASE        For an ad with an decreasing
  60.                             number.
  61.             INCREASE        For an ad with an increasing
  62.                             number.
  63.  
  64. SOURCE.x    Indicates where the ad's is to be taken from eg.
  65.             'Data:ad.txt'.
  66.  
  67. MISC.x      Misc. data, varies from type to type, will be
  68.             explained later on.
  69.  
  70. SUBDIR.x    Indicates that you want the ad in a subdir in
  71.             the archieve, so far subdirs in subdirs arent
  72.             supported so dont try stuff like
  73.             'SUBDIR.0=skod/borg/tåbe', it wont work.
  74.  
  75. As mentionen, the MISC.x filed varies from type to type,
  76. here comes the list:
  77.  
  78. NORMAL:     MISC.x is used for holding the name that will be
  79.             used as the ad's name in the archieve.
  80.  
  81.             TYPE.0=NORMAL
  82.             SOURCE.0=Data:ad.txt
  83.             MISC.0=Skodboard
  84.  
  85.             This would generate an ad in the archieve with
  86.             the name of 'Skodboard' with the content of
  87.             'Data:ad.txt'.
  88.  
  89. LHANAME:    MISC.x is used to hold what will be added to the
  90.             archives name.
  91.  
  92.             Imagine an archive called Pacmag41.lha
  93.  
  94.             TYPE.1=LHANAME
  95.             SOURCE.1=Data:ad.txt
  96.             MISC.1=Susperia
  97.  
  98.             This would generate an ad with the name
  99.             'Pacmag41.Susperia'.
  100.  
  101. RNDCHARS, RNDINTS, RNDCHARS&INTS and RNDAMOK:
  102.  
  103.             MISC.x is used for the length the string will
  104.             get.
  105.  
  106.             TYPE.2=RNDCHARS
  107.             SOURCE.2=Data:ad.txt
  108.             MISC.2=24
  109.  
  110.             This would generate an ad of random characters
  111.             with an length of 24 characters.
  112.  
  113. TICTACTOE:  This one is special, because it uses a new
  114.             tooltype, the MISC.x tooltype is used to hold
  115.             the length of the ad's name. The new tooltype is
  116.             TICWORD.x.y, here is an example:
  117.  
  118.             TYPE.3=TICTACTOE
  119.             SOURCE.3=Data:ad.txt
  120.             MISC.3=40
  121.             TICWORD.3.0=Super
  122.             TICWORD.3.1=Duper
  123.             TICWORD.3.2=Frog
  124.  
  125.             Thsi would generate an ad of 40 characters using
  126.             the words 'Super', 'Duper' and 'Frog' in a random
  127.             combination.
  128.  
  129. DECREASE:   Well, it is more difficult than TICTACTOE, anyway,
  130.             this one will continue to decrease the number it
  131.             will place in your ad by one until it reaches a
  132.             minimum you have defined, example follows:
  133.  
  134.             TYPE.4=DECREASE
  135.             SOURCE.4=Data:ad.txt
  136.             MISC.4=Seats Left_
  137.             DECREASECUR=200             <-- This is the current value
  138.             DECREASESTOP=0              <-- The minimum value
  139.  
  140.             The above entry would create something like
  141.             'Seats Left_200' first time it was executed and
  142.             'Seats Left_199' the second time, since it would
  143.             decrese the value in DECRESECUR by one each time
  144.             it is executed, until 0 (DECREASESTOP) is reached.
  145.             Please note that the DECREASESTOP tooltype can be
  146.             left out if not needed.
  147.  
  148. INCREASE:   Just the opposite of DECREASE, example:
  149.  
  150.             TYPE.5=INCREASE
  151.             SOURCE.5=Data:ad.txt
  152.             MISC.5=Uploads_
  153.             INCREASECUR=1
  154.             INCREASESTOP=1000000
  155.  
  156.             First time executed the following would be created:
  157.             'Uploads_1', the next time 'Uploads_2' and so on,
  158.             until 1000000 is reached. Please note that the
  159.             INCREASESTOP tooltype can be let out if not needed.
  160.  
  161. Let's take a look at those flags I mentioned earlier:
  162.  
  163. CHEATDIZ    This flag will make the adder more the FILE_ID.DIZ
  164.             down to the bottom of the archieve, handy if you
  165.             wants to evade strippers that only checks from the
  166.             file_id.diz and down.
  167.  
  168. QUIET       Will make the adder shut up about what it is adding,
  169.             this will also prevent the adder from showing how
  170.             bytes have been added and the archieve gain in
  171.             percents.
  172.  
  173. One last thing, if you want more than one flag, just use a | to
  174. seperate the flags (FALGS=CHEATDIZ|QUIET).
  175.  
  176. History:
  177. --------
  178.  
  179. Vo.5o       Beta test version for Susperia Only.
  180.  
  181. V1.oo       First release.
  182.             Added total bytes added indicator.
  183.             Added TICTACTOE type.
  184.  
  185. V1.25       Added archieve gain percentage.
  186.             Added decrease type.
  187.             Added increase type.
  188.             Optimized the copy() rutine.
  189.             Fixed a bug in RNDAMOK.
  190.             Fixed a bug reagrding length of strings.
  191.  
  192. Greetings:
  193. ----------
  194.  
  195. All the guys in Vanity, naturally... :)
  196.  
  197. Json, Devilstar, Zinko, Janitor, Deature, Striker, Energy,
  198. Spike, SCA, Relief, Webster, D-Tron, Playmate, Ironman,
  199. Nashua, Enzo, Carebear, Paranoid
  200.  
  201. And all the other m8 I forgot.
  202.  
  203. Wardancer of Vanity signing of
  204.  
  205.       7th September 1995
  206.